home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / tools / docs / ps3m < prev    next >
Text File  |  1994-06-12  |  11KB  |  313 lines
  1. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  2. ­                PS3M ® 002.4 / 12.6.94            ­
  3. ­            Copyright © 1994 Jarno Paananen            ­
  4. ­                 Guru / Sahara Surfers            ­
  5. ­             A Sahara Surfers Product 1994            ­
  6. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  7.  
  8. Some words about PS3M:
  9. ­­­­­­­­­­­­­­­­­­­­­­
  10.  
  11. This little thing could be just another program to play music.  It wouldn't
  12. even be the first one I have done.  The only special thing is that it plays
  13. S3M-modules.  For those to whom that word says nothing, can be told that
  14. they are the modules from all newer Future Crew demos (from Fishtro
  15. onwards), compotunes and the three Journey musicdisks and Chaotic Mind from
  16. Skaven.   After the recent release of ScreamTracker 3.01 Beta more and
  17. more modules are obviously coming from other musicians too, as it really
  18. is the best tracker on the PC.  As they use 1-32 channels (although "only"
  19. 16 digital channels and 9 AdLib-channels) and 8 octaves, a normal Amiga is
  20. not capable to play them, right?  Yes, until now.
  21.  
  22. From version 000.9 onwards also 6-8 channel FastTracker modules can be
  23. played with PS3M (should I change the name?!?).  Although you can play
  24. 4 channel ProTracker tunes, I think there are faster programs available
  25. for that :)...
  26.  
  27.  
  28. !!NOTICE!!:
  29. ­­­­­­­­­­­
  30. From version 002.0 onwards, PS3M has a config file!  Use of it is
  31. _recommended_!
  32.  
  33.  
  34. Technical "information":
  35. ­­­­­­­­­­­­­­­­­­­­­­­­
  36.  
  37. This player makes quite a big difference to those "normal" Amiga players as
  38. it has to mix all those channels to, in this case two, normal channels.
  39. This is the normal convention on the PC as for example normal SoundBlaster
  40. only has one digital channel.  The only hard part is to make it fast still
  41. having a great sound quality.  For those interested, this mixing routine is
  42. not one of those lame ones like in Startrekker, Octamed, Oktalyzer and so
  43. on.  It has real volumes and periods for each channel unlike the former ones
  44. that control the volume with hardware and have no independent volume
  45. control for channels.  It mixes the sound in 16 bits for maximum quality and
  46. has a volume boosting option to make the sound louder and clearer with
  47. multiple (8+) channels.  The actual mixing loop is highly optimized and has
  48. only 6 instructions (is faster than the one with 5...) per byte.  All this
  49. makes it possible to play even 8 channel S3Ms with high mixing rates and
  50. great quality.  The better (faster) your machine is, the higher rates you
  51. get.  It is designed to use as little chip-ram as possible to fasten up on
  52. machines with real fast-ram.  The system is disabled for the playing to get
  53. the maximum performance out of a normal A500.  From 000.2 onwards, system
  54. friendly option is included for those with AGA- or turbomachines and even
  55. for us poor mortals...  On a normal A500 it jams your machine nearly
  56. completely, so it isn't too useful for you.  Still I use it quite a lot
  57. with my A500, so it isn't too bad after all...
  58.  
  59. The yellow bars at the bottom of the screen indicate that the player has
  60. free time.  This helps you to tune the maximum mixing rate for each tune
  61. separately.
  62.  
  63. There has been some argue about whether the surround option is a real
  64. Dolby Surround or not.  Therefore: IT HAS NOTHING TO DO WITH THAT DOLBY
  65. THING, it is made just to enchance the dull stereo sound by playing
  66. the two buffers from left and right with full volume and vice versa with
  67. half of the volume.  Like this:
  68.     Channel 0 - Left buffer, full volume
  69.     Channel 1 - Right buffer, full volume
  70.     Channel 2 - Left buffer, half volume
  71.     Channel 3 - Right buffer, half volume
  72.  
  73. This should end that discussion.  Thanks for the ones who contributed
  74. with pertinent response.
  75.  
  76.  
  77. BUT!!!!
  78.  
  79. As everything changes these days, also PS3M now has Real Surround-option.
  80. It needs a little more processor power, but not that much I though.  Also
  81. extra 128 kB is needed for extra buffers.  It enchances the sound nicely
  82. with headphones and is nice also with normal speakers.  And if you got the
  83. Dolby Prologic decoder (lucky you!), you should get the effect quite
  84. nicely...
  85.  
  86.  
  87. Some commercial advertisement:
  88. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  89. This PS3M-routine is also used in the following players, so if you are not
  90. content with the user-interface, use these:
  91.  
  92. DASMP from DAS Design (from 3.0 onwards)
  93.  
  94. Hippopotamus Player from Hippopotamus Design (MUST for under 2.0
  95. Kickstarts, we still do exist!)
  96.  
  97. DeliTracker II already has a S3M-DeliPlayer (Hi Peter!) and should
  98. be available in near future.
  99.  
  100.  
  101. Possibly in new SmartPlay (if you contact me)
  102. Possibly in PowerMusic Pro (if I remember to send the source...)
  103.  
  104.  
  105. Look out for The Player 6.1 as it will be even better than 6.0 (surprise!)
  106. Coming out sooner or later...
  107.  
  108.  
  109. (As I recently got the sources of ProTracker 1.2D, there is a tiny
  110. possibility that I might do something with it and PS3M-routine...)
  111.  
  112.  
  113. Legal stuff:
  114. ­­­­­­­­­­­­
  115.  
  116.         This program and all other stuff coming in this package are
  117.                            FULLY copyrighted by
  118.  
  119.                  Jarno Paananen / Guru of Sahara Surfers.
  120.                  ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  121.  
  122. The author cannot be held liable for the suitability or accuracy of this
  123. manual and/or the program it describes.  Any damage directly or indirectly
  124. caused by the use or misuse of this manual and/or the program it describes
  125. is the sole responsibility of the user her/him self.
  126.  
  127. This program is freeware.  You can distribute it as long as _ALL_ files are
  128. included and not more than a nominal fee for copying is asked.  This program
  129. can _NOT_ be used for commercial purposes without written permission from
  130. the author and a contribution for development costs (like Coca-Cola :-).  If
  131. you have suggestions or remarks about this program, or if you find any
  132. bugs, please let me know.
  133.  
  134. All reverse engineering is forbidden and that means that you're not allowed
  135. to rip the player from this program as I'm intending to use it for
  136. commercial purposes.  If this happens I have to stop releasing these kind of
  137. programs.  If you are really interested and want to use this in some
  138. production, contact me and we can discuss about it.  It's up to you...
  139.  
  140.  
  141.  THIS IS A BETA-PRERELEASE-TEST VERSION AND IS IN CONSTANT CHANGE. FURTHER
  142.              VERSIONS ARE COMING IF THE ABOVE IS NOT VIOLATED.
  143.  
  144.  
  145.  
  146.  
  147. Contact address:
  148. ­­­­­­­­­­­­­­­­
  149.  
  150. If you for some odd reason (especially commercial stuff) want to contact me,
  151. the address is:
  152.  
  153.                 J. Paananen
  154.                    Puskalantie 6
  155.                 37120 Nokia
  156.                   Finland
  157.  
  158.            Or by phone: +358-31-3422147 / Jarno
  159.  
  160.  
  161.             Or preferably via Internet:
  162.  
  163.              gurus2@freeport.uwasa.fi
  164.                  (more preferable)
  165.  
  166.                     or
  167.  
  168.                jpaana@freenet.hut.fi
  169.  
  170.  
  171.  
  172. Some revision history:
  173. ­­­­­­­­­­­­­­­­­­­­­­
  174.  
  175. 002.4 / 12.6.1994
  176. ­­­­­­­­­­­­­­­­­
  177.     + Added show sample names option. Hi Icebeat!
  178.     - Fixed a bug when started from WB.
  179.     + Added contact info text.
  180.     - Little fixes.
  181.  
  182.  
  183. 002.3 / 25.5.1994
  184. ­­­­­­­­­­­­­­­­­
  185.     * Some speed improvements for 020+ (uses more lword access).
  186.       No slow down on 000/010.
  187.     * Recalculated S3M period table for NTSC (was PAL) as ST3s use
  188.       NTSC periods.
  189.  
  190.     + Little touches here and there (All error messages now start
  191.       with capital letter, etc. :)
  192.     - Fixes in command line parser.  NOTICE: system friendly option
  193.       is now just -s with no extras.  If not present, disable option
  194.       is used.
  195.     - No more crap if no config file present.
  196.     
  197.     Thanks again Deadbeat!
  198.  
  199.  
  200. 002.2 / 9.-10.5.1994
  201. ­­­­­­­­­­­­­­­­­­­­
  202.     (Four versions in three days... maybe I should give myself a break?
  203.      No new versions for a week, promise!)
  204.  
  205.     + REAL SURROUND!
  206.     - Hopefully fixed that >32 kHz bug (Yolk, tell me!)
  207.  
  208. 002.1 / 8.5.1994
  209. ­­­­­­­­­­­­­­­­
  210.     (Fast, eh Yolk?)
  211.     + Final solution for the screen mode problem, CIA!  So, now it
  212.       SHOULD work also with those modes.  But who uses them anyway, PAL
  213.       and A500 rule :)
  214.     + BTW, in Productivity mode you can get mixing rate up to 56 kHz!
  215.       Thus artificial 28 kHz limit changed to 56.  Note: as said works
  216.       only in Productivity mode.  (Yolk: You said something about
  217.       working also in double-PAL (double-NTSC too?))
  218.  
  219. 002.0 / 8.5.1994
  220. ­­­­­­­­­­­­­­­­
  221.     (Oops, another digit :-)
  222.     + PS3M now has a CONFIG FILE!  It resides in S: and is called
  223.       (surprise, surprise!) PS3M.config.  Check it out for format
  224.       and options.
  225.     - Still little fixes.
  226.     - Channel detection routine had some _serious_ bugs.  Fixed.
  227.     + At last, error messages!
  228.     - Loading a non-existent file crashed the machine.  Fixed.
  229.  
  230. 001.1 / 7.5.1994
  231. ­­­­­­­­­­­­­­­­
  232.     - Still more bug fixes in system routines.
  233.     + Should work (at least better) under NTSC and Multiscan modes. (Hi
  234.       Yolk!)
  235.  
  236. 001.0 / 5.5.1994
  237. ­­­­­­­­­­­­­­­­
  238.     ? Darn, slipped to the next digit :-)...
  239.     - Fixed a bug in my XPK-loader, should work better although I
  240.       haven't noticed the difference...
  241.     * Changed the priority to 4 to make it more usable with slower
  242.       machines in system friendly mode.
  243.     - Crashes with slow machines should be over! (or at least less...)
  244.     * Changed to colors (now HiP-compatible :-) in system killer mode!
  245.  
  246.     Thanks to K-P Koljonen for these! (Hi again, sending coming
  247.     sometime in the future :)
  248.  
  249.     - The module name wasn't shown if started from command line in
  250.       system friendly mode, fixed.  Thanks Deadbeat!
  251.  
  252.     - Fixed a potential bug in sample offset command.
  253.     - Now you don't have to click the stop gadget twice
  254.  
  255. 000.9 / 24.04.1994
  256. ­­­­­­­­­­­­­­­­­­
  257.     + Added FastTracker 6-8 channel and 4 channel ProTracker replay!
  258.     ? Should the name be changed?  Opinions been accepted.
  259.     + Added command line options to bypass the requesters. See usage
  260.       by typing PS3M ?
  261.  
  262. 000.8 / 08.04.1994
  263. ­­­­­­­­­­­­­­­­­­
  264.     + Changed the mixing loops to use 6 instructions, which made them
  265.       faster (2 cycles/byte/channel on 68000). Thanks Peter Kunath!
  266.     - Some potantial bugs fixed.
  267.  
  268. 000.7 / 22.03.1994
  269. ­­­­­­­­­­­­­­­­­­
  270.     + Added shortcuts for requesters
  271.     + Added skipping of positions $ff, which are separators of
  272.       different songs in one module. Used in TMP.S3M.
  273.  
  274. 000.6 / 19.03.1994
  275. ­­­­­­­­­­­­­­­­­­
  276.     - Added range checking to sample offset.
  277.     - Implemented some bugs in STMIK. Now PANIC.S3M plays correctly.
  278.  
  279. 000.5 / 08.03.1994
  280. ­­­­­­­­­­­­­­­­­­
  281.     - Some "little" fixes in retrig note. Wonder if it worked at all...
  282.  
  283. 000.4 / 25.02.1994
  284. ­­­­­­­­­­­­­­­­­­
  285.     - Ooops, Vibrato+Volslide and Toneportamento+Volslide were the
  286.       wrong way around. Too much Protracker-experience?
  287.  
  288. 000.3 / 24.02.1994
  289. ­­­­­­­­­­­­­­­­­­
  290.     + Support for other than 50 Hz screenmodes (was a bug really...)
  291.     + Correct CurrentDir
  292.     ? Crashes under system are probably due to too slow machine as on
  293.       A4000 this doesn't happen at all... Trying to fix it...
  294.     ? Planning some support for other multichannel modules (MTM, 669,
  295.       FastTracker 6 and 8 channels, etc...) Infos about these modules
  296.       are appreciated...
  297.  
  298. 000.2 / 10.02.1994
  299. ­­­­­­­­­­­­­­­­­­
  300.     + Added system friendly option!
  301.     - For some odd reason some tunes crash under system...
  302.     ! BTW, my birthday is on the 17th!
  303.  
  304. 000.1 / 09.02.1994
  305. ­­­­­­­­­­­­­­­­­­
  306.     - Fixed a bug with volumeslide. Now Satellite One plays correctly.
  307.     - Auch! I had left some fast-mem-only hunks in the executable.
  308.       Fixed.
  309.  
  310. 000.0 / 03.02.1994
  311. ­­­­­­­­­­­­­­­­­­
  312.     ! Inital release on public pressure...
  313.